Amiga Collections: Scope

home *** CD-ROM | disk | FTP | other *** search

/ Amiga Collections: Scope / Scope Disk #017 (199x)(Scope PD)(US)[WB].zip / Scope Disk #017 (199x)(Scope PD)(US)[WB].adf / du361m2 / M2Du361.docs < prev next >

Wrap

Text File | 1988-06-23 | 18KB | 486 lines

M2Du 3.61 ~~~~~~~~~ - By Greg Browne - 1821 Ocotillo, Alamogordo NM 88310 (505) 437-0807 DirUtil in Modula-2 - 50-1000 files CLI or WB Last modified - 6/24/88 CONTACT: CIS [72250,106] Alamo FastKode ROS (505)-437-2280 (24 hr 300-9600 baud) New Horizons (505)-437-9117 (7pm-8am 300-2400) DISCLAIMER: I am not responsible for anything! Use at your own risk. P.D. NOTICE: This executible is placed in the public domain. FREE! THANKS: Richie Bielack, Martin Taillefer, Matt Dillon, Brett Blevins, Jim Kunzman, Chuck Layton, Rick Sinars and others for various reasons. WARNING - *MAJOR* CHANGES BACK IN 3.42. +++++++++++++++++ GENERAL OPERATION +++++++++++++++++ CLITail: Accepts arguments (not in WB yet): i = Incr max files-per-dir by 50 (multiple 'i' ok). d = Decr max files-per-dir by 50 (multiple 'd' ok). b = Window to BOTTOM half of SCREEN (if INTERLACED). COMMAND ACTIVATION: LEFT & RIGHT mouse button press & RELEASE over gadget (or name) to register. CONFIRMING: Messy & destructive commands need confirmation. When asked to "HIT (name) again", USE THE LEFT MOUSEBUTTON. The right mousebutton will NOT confirm actions, even those started with the right mousebutton. INTERRUPTING: Multi-actions interrupt by clicking a gadget (including filewindow) with the LEFT mousebutton. Stop is AFTER current pass is complete. When the alternate pointer is visible, clicks are ONLY interrupts. Getting files interrupts with a click in the filewindow. If directory has too many files, you will be warned. EXECUTE/RUN: DO, EDIT, & SHOWIFF execute sequentially (prevent disk grinding) until the last (or only) action. Then RUN >NIL: is used to free up Du. When commands finish, they do NOT re-read the directory (save more grinding when command is RUN). Use hidden 'S' gadget to re-read. TITLE BAR: nnn/tttt Time 00:00 R-0 Chip nnnnnn Fast nnnnnnn Total nnnnnnnn --------- ---------- --- ------------------------------------------ current 24 hr Which Memory availability files/max format history item active INITIAL DIRECTORY: Logs into ram: if run from WorkBench. Logs into Current Dir from CLI. SIZING WINDOW: Normal AND 'hidden' gadget. Instantly shrink by clicking the open space below the title bar. Unshrink by clicking hanging space below the title in the tiny window. Tiny window moves - remembers where it was. DEVICE GADGETS: -> df0: df1: ... etc. LEFT mouse = put this into S with immediate 'GET'. RIGHT mouse = put this into the D gadget. [Patchable. See end of this doc] FILEWINDOW GADGET: Click unselected file OR dir and it is "selected". Click a selected name to unselect it. Most actions need "selected" things to work. NOTE: Any/all filenames AND/OR DIRS may be selected at once. See "HIDDEN GADGETS" for a 'HOLD' feature in display. SLIDER GADGET: Scroll filename window. If slider is filled, all files and directories are displayed. /\ and \/: LEFT mouse = move 1 file in arrow direction RIGHT mouse = move 1 SCREEN in arrow direction MULTIPLE R GADGETS (HISTORY): 'R' holds a circular list of 10 strings. "R+ R-" scrolls them, and R#:n in title bar tells which one is in use. Startup looks for a file named Du.hist in the current directory, and if not found, in the S: directory. FIRST one found will be used to initialize the strings to = the first 10 lines of the file. If NEITHER found, all R gadgets will be empty. The file is just lines in plain text, and anything over 10 lines will be ignored. A sample file is included. History changes must be typed in AND <ENTER>ed while program waits for normal gadget activity to be permanent. Remember, while commands are going on, the program only looks at gadget selection as an interrupt. Changes made during activity, OR ended without <ENTER>ing will be TEMPORARY. Then, scrolling history +- will return last saved history for that item. Experiment with it. STRING I/O GADGETS: -> R S D All are 255 characters long, but only part of string is seen. To view a long string, activate the gadget, and use arrows to move through it. (R)un holds command line info for RUN f<ile>+R. May also be used alone OR as the lead item in a command with highlighted file as tail if RUN R+f<ile> used. SEE ALSO HISTORY ABOVE AND THE 'R+ R-' button section. (S)ource holds name of the current active device or dir. LEFT mouseclick a device gadget and its goes here. CLICK, TYPE, AND <ENTER> in this gadget, and your entry will be new current device or dir. If access to it fails, the program returns to the last good active dir (or to ram: if that fails). Click the RIGHT mousebutton IN the box and a PARENT command is done. (D)estination holds the name of the path (filename in some cases) to use for certain GADGET functions. Clicking the RIGHT mousebutton IN the box backs the name up to its PARENT level (if any). The Message area at the bottom is NOT a gadget. HIDDEN GADGETS: Click LEFT mousebutton on LETTER 'R' or 'D' to blank contents of the box. Click LETTER 'S' for directory re-read of 'S'. RIGHT mouse on "S" toggles mode and color. Black (original color) means re-reads always display from file number 1. Green (same as device names) means re-reads try to display from the same position as last one. [For comparing similar directories or seeing changes in the middle of one.] Finally, there is another unmarked gadget mentioned. Find it yourself (may encourage someone to read this stuff). +++++++++++++++ BUTTON GADGETS: (alphabetically - sortof) Gadgets NOT alphabetic on screen +++++++++++++++ COPY (Multifile - consecutive) ---- Copy any/all selected file(s) to PATH in D (must be a valid device or dir). Multiple copy supported, copy to specific filename not supported. Checks PROTECT gadget setting. LEFT mouse = STOP if file status does not match PROTECT gadget. RIGHT mouse = SKIP that file and go on. COPYALL (CONFIRMED) (Mass file/directory copy) ------- Copy entire dir/disk contents, matching tree structure on the fly. Put base level source dir name in S and the base dest PATH in D and select COPYALL (and confirm). This copies EVERYTHING in S AND ITS SUBDIRECTORIES to D, creating directories as it goes. IF destination fills, you will have a chance to change disks and continue. Ex: Copy entire disk (like COPY df0: to df1: all) type 'df0:' in S and 'df1:' in D and go. Copy devs directory Put 'df0:devs' in S and 'df1:devs' (existing OR NOT) in D, and start. Creates (if needed) destination directory, copies all files, creates df1:devs/printers (if needed) and copies all its files. Specifically confirmed, DOES NOT check PROTECT setting. COPYif (CONFIRMED) ------ Just like COPYALL, BUT with attention to ARC bit of source FILE's protection bits. If bit is CLEAR (file changed since last set) it WILL copy the file. If a DIRECTORY bit is SET it doesn't even go into that directory. LEFT mouse = SET source ARC bit after copy done RIGHT mouse = DON'T mess with ARC bit DELDIR (CONFIRMED) ------ DIRECTORY delete. To work, dir must be selected and EMPTY. ANY/ALL highlighted directories will be deleted if empty. LEFT mouse = stop if a directory doesn't delete. RIGHT mouse = continues EVEN if a directory doesn't delete DELETE (CONFIRMED) (Multifile - consecutive) ------ FILE delete. Any/all files currently highlighted will be deleted. Message area shows progress, and delete may be stopped by clicking left mouse button on any gadget (including filewindow). DSKCOPY (CONFIRMED) ------- Diskcopy 'S' to 'D' - BOTH MUST BE df0-df3. Corrects date so DOS won't be confused. IS Interruptible. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY DSKWIPE (CONFIRMED) ------- QUICK WIPE OF disk in 'D'. MUST BE df0-df3. Writes fresh root block. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY DO f+R DO R+f (Multifile - consecutive) ------ ------ RUN/EXECUTE command. DO R+f executes the 'R' contents with selected items as a tails. DO f+R executes selected items with the 'R' content as a tail. If no item is selected, both try the R gadget alone. Uses DOS Execute (like typing a command at > prompt). Also whether command is RUN or executed depends on other things (more info in first section). This is NOT like script handler 'EXECUTE'. *DOES* INCLUDE HIGHLIGHTED DIRECTORY NAMES IN THE ACTIONS EDIT (Multifile - consecutive) ---- Start editor with selected FILEname(s) as tail(s). If no file selected, editor will be RUN with no file. Expects editor named 'dme' in normal search path and uses the same Execute/Run logic as DO buttons (SEE PATCHING). FORMAT ------ FORMAT disk indicated in 'D'. MUST BE df0-df3. Names disk "New" and uses current date. DOES INSTALL as bootable. IS Interruptible. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY F+ F- ----- Change #files-per-directory handled by DU. LEFT mouse = increase 50 RIGHT mouse = decrease 50. (More files = more memory used.) GETDIR (NO SUCH GADGET) ------ GETDIR by clicking the RIGHT mouse button over its name. HPRINT HTYPE PRINT TYPE ------ ----- ----- ---- ASCII/HEX file view/print. Destination of PRINT/HPRINT selected with toggle gadget PRT: (See TOGGLES/FLAGS section). Multiple hardcopy runs interrupt the same way as other functions. To scroll back and forth in file during screen output, click left mouse down in upper or lower part of window, or use scroll bar. Click title bar to quit or interrupt an individual printout or display. Tabs expanded on 8 columns. NO color sequences or formfeeds. Line xx of xxx shown in the title bar. For PRINT this is 256 byte blocks NOT lines. NOTE: If PRINT/HPRINT selected with RIGHT mouse, formfeed will be sent after each file. INFO ---- LEFT mouse = FREE space S and/or D RIGHT mouse = USED space S and/or D. Both show volume name[s]. INSTALL ------- INSTALL disk indicated in 'D'. MUST BE df0-df3. Writes fresh boot block. LEFT mouse = NOVERIFY RIGHT mouse = VERIFY MAKEDIR ------- Make dir named in the D gadget (if valid and not existing). If complete dev:path not given, dir will be made relative to the path in S. Check is made to insure you are not trying to create a directory with an already existing name (or over a file). LEFT mouse = DO re-read S when done RIGHT mouse = DON'T re-read. MOVE (Multifile - consecutive) ---- MOVE items to destination (must be path). Tries RENAME. If that fails, and 'item' is NOT a directory, tries copy-and-delete-source. DOES check state of the PROTECT gadget. LEFT mouse = STOP if item does not match PROTECT gadget status RIGHT mouse = SKIP that item and go on. *WARNING* - A bug in the ram-handler lets you rename a file in ram: to an existing name in ram: without a DOS error 203 and leaves you 2 in the same directory. Just so you will be aware, I didn't try to trap that. (* vd0: also does that! *) OldNew ------ Tag files based on destination condition. LEFT mouse = tag files which DO exist at dest end (Old) RIGHT mouse = tag files which DO NOT exist at dest end (New). PARENT ------ Click RIGHT mousebutton in 'S' or 'D' box for PARENT. ROOT ---- Back up to the root of the current S or D gadget. If this fails with 'S', return to the last good current directory (or ram: as a last resort). LEFT mouse = Get ROOT of 'S' RIGHT mouse = Backup 'D' to its ROOT level RELABEL ------- Relabel disk in 'S' to NAME in 'D', both in memory and on disk. Internal. 'D' gadget cannot have ":" or "/" in it. RENAME ------ Rename FIRST selected file OR dir (alphabetically) to Name in the D gadget. Wherever practical, MOVE is faster. LEFT mouse = re-read directory (since it may be still be there) RIGHT mouse = NO re-read (old dropped, new not added even if still there). TAGALL RETAG FLIPTAG UNTAG ------ ----- ------- ----- Mass tag operations on all items in a window. (In some DU's -> TAGALL = ALL UNTAG = CLEAR) TAGALL selects ALL items. RETAG after multifile operations reselects any items selected before (if they remain now). FLIPTAG reverses all tags. UNTAG clears all tags. LEFT mouse = do with FILES. RIGHT mouse = do with DIRECTORIES. SETNOTE ------- Set filenote of FIRST HIGHLIGHTED file OR dir. Current R gadget content will be used as comment. To delete a comment, empty R gadget and SETNOTE (to null comment). SHONOTE ------- Show filenote (if any) of FIRST HIGHLIGHTED file. Filenote will be shown in the message area. If [-no comment-] appears, file has no filenote attached to it. SETPROT ------- Set protection bits on highlighted FILE(s) OR DIR(s). LEFT mouse = work this on FIRST item found highlighted. RIGHT mouse = work this on ALL items highlighted. R gadget must hold letter(s) of bits you want SET. Does NOT consider CURRENT condition of flags - you must include ALL letters you want set. To get current status, use SHOPROT. Order of letters does NOT matter. Letters not present will have their bits CLEARED. Protection bits are (UPPER or lower case o.k.): A(rchive bit) Currently RESET each time a file is changed R(ead protect bit) Ignored by DOS now W(rite protect bit) Ignored by DOS now E(xecute protect bit) Ignored by DOS now D(elete protect bit) Prevents deletion when SET SHOPROT ------- Shows protection bit status on highlighted file OR directory. Uses current R gadget, so be careful of History items. LEFT mouse = show NEXT highlighted (and unselect) RIGHT mouse = scan quickly through ALL highlighted (and unselect) SHOWIFF ------- Picture display. INTERNAL - does NOT need any "Show" program. Works on most wellbehaved ILBM files. Based on UShow2.asm logic. ZAPALL ------ Mass directory-and-related-files delete. Works two ways. 1) If a directory name IS highlighted when ZAPALL is selected, it assumes you want to delete that directory AND ALL FILES AND SUBDIRECTORIES IN IT. 2) If NO directory name highlighted, it assumes you want to delete CONTENT of the directory (or device) in the S gadget, including ALL files and subdirectories, BUT NOT directory itself. (This leaves an empty, but existing, directory. Example: 1) Delete all files in df1:devs (but not df1:devs itself). Put df1:devs in S and go. This leaves an empty df1:devs as the S directory. 2) Delete its files AND IT, TOO. Put 'df1:' in S and select 'devs' with one click. Then hit ZAPALL twice (once to select ZAPALL, once to CONFIRM ZAPALL), and all the files and directories in 'devs' will be deleted, then devs will be deleted (unless it is ASSIGNed to devs:). Gives message area progress reports. Deletes files alphabetically backward, recursing into directories as encountered. Watch and see. R+ R- ----- Scroll R history. READ 'HISTORY' EXPLANATION. LEFT mouse = + RIGHT mouse = - f->R f->D ---- ---- Move FIRST highlighted file (OR directory) into indicated gadget. RIGHT mouse on f->D = CONCAT the first item into D (with / if needed). R->S R->D etc. ---- ---- Copy current gadget contents around. If R involved, affected history item is updated. IF S involved, it is treated like a new entry. R<->S etc. ----- Two-way swaps of gadget content. S<->D is the old SWAP command. If S is involved, it will be treated as though typed in fresh. If R gadget is involved, affected history item is updated. +++++++++++++++++++++ TOGGLE (FLAG) GADGETS +++++++++++++++++++++ PROTECT/ERASE/REPLACE --------------------- Indicates protection used for files at destination end of COPY and MOVE. (Not honored by COPYALL, COPYif, or ZAPALL, which must be confirmed.) 1. PROTECT - Don't continue if same name file EXISTS at destination. 2. ERASE - Don't care about file of same name at destination. 3. REPLACE - Don't continue UNLESS file of same name EXISTS at destination. DevNAME/VolNAME --------------- Indicates what type of names S gadget will use. 1. DevNAME - df0:?? df1:?? etc. will be used. 2. VolNAME - disk names (MyVol:??) will be picked up. May be useful where one drive swaps are involved. Drawback in VolNAME mode. ASSIGNed names like devs: can't be used. Program assumes you want Volume Name of the disk that ASSIGNed device is on and goes to the root expressed as volume name. SIZES/DATES =========== Indicates what to display about files. Changes when hit. 1. SIZES - byte file size will show. 2. DATES - creation dates will show. SysDATE/OldDATE =============== Select date to put on copied files. 1. SysDATE - current system date goes on copies. 2. OldDATE - creation date of source file goes on copies. PRT: PAR: SER: ============== Shows destination of PRINT/HPRINT gadgets. (See Patching.) = - = - = - = - = MOST PEOPLE - CUT HERE = - = - = - = - = - = - = PATCHING [with NewZap] Editor name: Change only occurrance of 'dme' (no quotes) to a null terminated string of your choice. Space for up to a 10 character name. Default PRINT/HPRINT output device: Find only occurrance of PRT:<0>PAR:<0>SER:<0>. The first is default on startup. Swap order to your preferences, remembering to keep them 4 characters long plus nullterm. Devices - df0: df1: ... etc.: If you have a different named device (like nv0: or dh2: or something), you can find the only place where the names appear in an ordered set of null terminated strings. THIS IS BOTH GADGET TEXT AND TEXT USED TO TRY TO LOCK THE DEVICE. Rearrange or change what's there (with up to 4 letters each). Whatever you put into the ram: (last) gadget will be what is logged into first from WorkBench. What appears in each gadget will be what the program tries to access and CurrentDir to when it is selected. Be careful.